Maintenance updates and API version enhancements and enhanced error handling for the Blob and Queue services by jainakanksha-msft · Pull Request #2675 · Azure/Azurite

jainakanksha-msft · 2026-07-20T13:35:28Z

This pull request introduces several dependency updates, service API version bumps, and important fixes for startup and shutdown reliability, as well as refactors to improve error handling and maintainability. The most significant changes are grouped below:

Dependency and API Version Updates:

Applied npm audit fix and updated dependencies such as axios, morgan, and esbuild to address security vulnerabilities and maintenance issues (package.json). [1] [2]
Bumped the default Blob, Queue, and Table service API version to 2026-06-06, and added support for 2026-04-06 and 2026-02-06 for these endpoints (ChangeLog.md).

Startup and Shutdown Reliability:

Fixed issue 3.36.0 Error on Container Start #2672: Improved startup reliability for Blob and Queue services by adding backward-compatible restore for persisted contentMD5 formats and avoiding GC-triggered close() calls during server startup (ChangeLog.md).
Refactored shutdown logic to include better diagnostics and safer closure of services, ensuring errors during shutdown are logged with context (src/azurite.ts).

Garbage Collection (GC) Critical Error Handling:

Centralized and improved handling of GC critical errors in Blob and SQL Blob servers by using a new handleGCCriticalErrorClose helper, providing more informative logs and robust shutdown on GC failures (src/blob/BlobServer.ts, src/blob/SqlBlobServer.ts). [1] [2]

Code Quality and Maintainability:

Refactored and formatted code in LokiBlobMetadataStore for improved readability and maintainability, including better async handling, consistent formatting, and clearer error conditions (src/blob/persistence/LokiBlobMetadataStore.ts). [1] [2] [3] [4]

Documentation:

Updated ChangeLog.md to clearly document all major changes, fixes, and enhancements for this release. [1] [2]

Copilot

Copilot wasn't able to review any files in this pull request.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copilot

Pull request overview

Copilot reviewed 1 out of 2 changed files in this pull request and generated 1 comment.

Copilot

Pull request overview

Copilot reviewed 2 out of 3 changed files in this pull request and generated no new comments.

Comments suppressed due to low confidence (1)

ChangeLog.md:9

Changelog entry is grammatically awkward (“Applied npm audit fix to updates…”). Consider rephrasing so the sentence reads clearly.

- Applied npm audit fix to updates across multiple dependencies to address security vulnerabilities and maintenance updates.

Copilot

Pull request overview

Copilot reviewed 5 out of 7 changed files in this pull request and generated 1 comment.

Copilot

Pull request overview

Copilot reviewed 5 out of 7 changed files in this pull request and generated no new comments.

Comments suppressed due to low confidence (1)

ChangeLog.md:9

Wording/grammar: “Applied npm audit fix to updates…” is awkward and reads like a partial sentence. Consider rephrasing to make the changelog entry clearer.

- Applied npm audit fix to updates across multiple dependencies to address security vulnerabilities and maintenance updates.

Fixes race condition where GC error during startup would attempt to close server while still in 'Starting' state, resulting in 'Cannot close server in status Starting' error. Changes: - Modified BlobServer and QueueServer error handlers to wait for server to reach 'Running' state before attempting close - Added timeout logic (up to 5 seconds) to wait for server startup completion - Gracefully handles case where server cannot transition to Running state - Allows Azurite to recover when encountering errors processing legacy persisted data from previous versions Fixes: #2672

- Added 4 test files with 10 total test cases covering: * Unit tests for GC error handler state machine (3 tests) * Blob server startup error recovery scenarios (3 tests) * Upgrade regression tests (3.35.0 to 3.36.0+) (2 tests) * Queue server startup error recovery scenarios (2 tests) - Tests validate: * Fresh start scenarios without persisted data * Graceful error handling during GC initialization in Starting state * Concurrent startup operations * Data persistence across upgrade scenarios * Multi-container and multi-blob scenarios * Recovery from timeout conditions - All 777 tests passing (including 10 new tests) - No regressions in existing tests - Full TypeScript compilation clean

Copilot

Pull request overview

Copilot reviewed 16 out of 18 changed files in this pull request and generated 3 comments.

Copilot

Pull request overview

Copilot reviewed 17 out of 19 changed files in this pull request and generated 4 comments.

Copilot

Pull request overview

Copilot reviewed 17 out of 19 changed files in this pull request and generated 3 comments.

Copilot

Pull request overview

Copilot reviewed 17 out of 19 changed files in this pull request and generated 2 comments.

Copilot

Pull request overview

Copilot reviewed 17 out of 19 changed files in this pull request and generated 1 comment.

Copilot

Pull request overview

Copilot reviewed 17 out of 19 changed files in this pull request and generated 1 comment.

Copilot

Pull request overview

Copilot reviewed 18 out of 20 changed files in this pull request and generated 2 comments.

Copilot

Pull request overview

Copilot reviewed 18 out of 20 changed files in this pull request and generated no new comments.

Comments suppressed due to low confidence (1)

src/blob/SqlBlobServer.ts:116

In the GC critical error handler, JSON.stringify(error) will usually log {} when error is an Error instance, losing the message/stack in Azurite logs (console gets it, but logger output becomes unhelpful). Log the error message + stack explicitly (and keep the console output if desired).

      (error) => {
        // tslint:disable-next-line:no-console
        console.log(BEFORE_CLOSE_MESSAGE_GC_ERROR, error);
        logger.info(BEFORE_CLOSE_MESSAGE_GC_ERROR + JSON.stringify(error));

…andling for the Blob and Queue services (#2675) * Updated npm package fixes * Updated changelog * Bump morgan and refresh audit changelog note * Bump service API versions to 2026-06-06 and update changelog * Bump axios/esbuild and update constants * Fix #2672: Handle GC startup errors during server initialization Fixes race condition where GC error during startup would attempt to close server while still in 'Starting' state, resulting in 'Cannot close server in status Starting' error. Changes: - Modified BlobServer and QueueServer error handlers to wait for server to reach 'Running' state before attempting close - Added timeout logic (up to 5 seconds) to wait for server startup completion - Gracefully handles case where server cannot transition to Running state - Allows Azurite to recover when encountering errors processing legacy persisted data from previous versions Fixes: #2672 * Add comprehensive test suite for issue #2672 - Added 4 test files with 10 total test cases covering: * Unit tests for GC error handler state machine (3 tests) * Blob server startup error recovery scenarios (3 tests) * Upgrade regression tests (2 tests) * Queue server startup error recovery scenarios (2 tests) - Tests validate: * Fresh start scenarios without persisted data * Graceful error handling during GC initialization in Starting state * Concurrent startup operations * Data persistence across upgrade scenarios * Multi-container and multi-blob scenarios * Recovery from timeout conditions - All 777 tests passing (including 10 new tests) - No regressions in existing tests - Full TypeScript compilation clean

Updated npm package fixes

d48f7d3

Copilot AI review requested due to automatic review settings July 20, 2026 13:35

Copilot AI reviewed Jul 20, 2026

View reviewed changes

Updated changelog

89b3837

Copilot AI review requested due to automatic review settings July 20, 2026 13:36

Copilot started reviewing on behalf of jainakanksha-msft July 20, 2026 13:37 View session

Copilot AI reviewed Jul 20, 2026

View reviewed changes

Comment thread ChangeLog.md Outdated

Bump morgan and refresh audit changelog note

1f74085

Copilot AI review requested due to automatic review settings July 20, 2026 14:08

Copilot started reviewing on behalf of jainakanksha-msft July 20, 2026 14:08 View session

Copilot AI reviewed Jul 20, 2026

View reviewed changes

Bump service API versions to 2026-06-06 and update changelog

691ecf6

Copilot AI review requested due to automatic review settings July 21, 2026 10:40

Copilot started reviewing on behalf of jainakanksha-msft July 21, 2026 10:41 View session

Copilot AI reviewed Jul 21, 2026

View reviewed changes

Comment thread src/table/utils/constants.ts Outdated

Bump axios/esbuild and update constants

b8eebad

Copilot AI review requested due to automatic review settings July 21, 2026 11:15

Copilot started reviewing on behalf of jainakanksha-msft July 21, 2026 11:15 View session

Copilot AI reviewed Jul 21, 2026

View reviewed changes

jainakanksha-msft added 2 commits July 21, 2026 16:51

jainakanksha-msft changed the title ~~Updated npm package fixes~~ Maintenance updates and API version enhancements Jul 23, 2026

jainakanksha-msft linked an issue Jul 23, 2026 that may be closed by this pull request

Support service version 2026-06-06 #2678

Closed

Fixed actual deserialization issue

c93db61

Copilot AI review requested due to automatic review settings July 23, 2026 09:19

Copilot started reviewing on behalf of jainakanksha-msft July 23, 2026 09:19 View session

Copilot AI reviewed Jul 23, 2026

View reviewed changes

Comment thread src/blob/BlobServer.ts Outdated

Comment thread src/queue/QueueServer.ts Outdated

Comment thread src/blob/persistence/LokiBlobMetadataStore.ts

Updated Changelog

ea654a9

Copilot AI review requested due to automatic review settings July 23, 2026 09:27

Copilot started reviewing on behalf of jainakanksha-msft July 23, 2026 09:28 View session

Copilot AI review requested due to automatic review settings July 23, 2026 13:07

Copilot started reviewing on behalf of jainakanksha-msft July 23, 2026 13:08 View session

Copilot AI reviewed Jul 23, 2026

View reviewed changes

Comment thread tests/blob/startupErrorRecovery.test.ts

Comment thread tests/queue/startupErrorRecovery.test.ts

Comment thread tests/table/auth/sas.test.ts

Comment thread tests/blob/upgradeRegression.test.ts Outdated

Addressed Remaining review comments

fd0db7b

Copilot AI review requested due to automatic review settings July 23, 2026 13:38

Copilot started reviewing on behalf of jainakanksha-msft July 23, 2026 13:39 View session

Copilot AI reviewed Jul 23, 2026

View reviewed changes

Comment thread src/azurite.ts

Comment thread src/blob/BlobServer.ts

Comment thread src/queue/QueueServer.ts

coplot review comments fixed

327c2eb

Copilot AI review requested due to automatic review settings July 27, 2026 07:29

Copilot started reviewing on behalf of jainakanksha-msft July 27, 2026 07:30 View session

Copilot AI reviewed Jul 27, 2026

View reviewed changes

Comment thread tests/blob/startupErrorRecovery.test.ts Outdated

Comment thread tests/queue/startupErrorRecovery.test.ts Outdated

jainakanksha-msft requested a review from Copilot July 27, 2026 07:45

Copilot started reviewing on behalf of jainakanksha-msft July 27, 2026 07:46 View session

Copilot AI reviewed Jul 27, 2026

View reviewed changes

Comment thread src/common/GCCriticalErrorCloseHelper.ts

Fixed copilot comments

8acc59c

Copilot AI review requested due to automatic review settings July 27, 2026 08:19

Copilot started reviewing on behalf of jainakanksha-msft July 27, 2026 08:20 View session

Copilot AI reviewed Jul 27, 2026

View reviewed changes

Comment thread src/blob/BlobServer.ts

Addressed copilot review

ce354cd

Copilot AI review requested due to automatic review settings July 27, 2026 08:37

Copilot started reviewing on behalf of jainakanksha-msft July 27, 2026 08:37 View session

Copilot AI reviewed Jul 27, 2026

View reviewed changes

Comment thread tests/blob/startupErrorRecovery.test.ts Outdated

Comment thread tests/queue/startupErrorRecovery.test.ts Outdated

Fixed copilot comment

df0a4d4

Copilot AI review requested due to automatic review settings July 28, 2026 10:01

Copilot started reviewing on behalf of jainakanksha-msft July 28, 2026 10:02 View session

Copilot AI reviewed Jul 28, 2026

View reviewed changes

jainakanksha-msft merged commit 696602d into main Jul 29, 2026
81 of 82 checks passed

jainakanksha-msft deleted the akkuVulFixes branch July 29, 2026 07:10

Uh oh!

Conversation

jainakanksha-msft commented Jul 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

jainakanksha-msft commented Jul 20, 2026 •

edited

Loading